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Introduction 



This document describes the installation and troubleshooting procedures for the set of 
command line utilities used to configure nPartitions on HP partitionable systems, such as 
Superdome, when installed on a computer system running Microsoft Windows. It covers 
issues that may arise during installation, configuration, and operation of the commands. Note 
that while some of the operational issues may also occur when the commands are executed 
from an HP-UX 1 li version 2 system, the installation and configuration issues cover only the 
Windows operating system. 

The primary audience for this document consists of HP technical support engineers and 
technical support personnel of HP customers. 

Definitions 



Cell 


A component of a partitionable 




complex consisting of 




processors, memory, and an I/O 




bus. 


Complex 


A server that can be divided into 




multiple nPartitions 


I/O chassis 


A component of a partitionable 




complex consisting of a number 




of PCI or PCI-X I/O card slots, 




which can be connected to the 




I/O bus of a particular cell. 


nPartition 


A collection of cells (and their 




connected I/O chassis) that 




functions together as a computer 




system. 



Theory of operation 

HP systems, such as the Superdome series of platforms, may be partitioned into one or more 
nPartitions, each containing at least one cell and at least one I/O chassis. The nPartition 
configuration on any partitionable complex can be changed through a set of command line 
utilities (the "par commands") or a graphical tool, parmgr. At the current time, only the par 
commands have been ported to Microsoft Windows. The supported configurations for a PC to 
run the par commands are described later. 

It is important to note that any partitionable complex that supports remote configuration can 
be configured from either a supported Windows PC or a computer running HP-UX Hi 
version 2 regardless of the operating system running in any nPartition on the complex. Thus, 
a Windows PC could be used to remotely configure a complex where all nPartitions on that 
complex run HP-UX. Similarly, an HP-UX 1 li version 2 system could be used to configure a 
complex where all nPartitions are running a supported version of Windows for Itanium® 2. 
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See the HP System Partitions Guide (Reference 1) for more information on using the par 
commands or parmgr to configure nPartitions on a complex. 

Supported Configurations 

The par commands and related components are supported on the following platforms: 

1. Any HP system running HP-UX 1 li version 2. The commands and all related 
components are installed with the operating system. 

2. Any PC on the supported hardware list for Windows 2000 Professional or Server, with 
Service Pack 3 or greater. 

3. Any PC on the supported hardware list for Windows XP Professional, with Service Pack 
1 or greater. 

4. Any PC on the supported hardware list for Windows 2003 Server for IA-32. 
Reference PC platforms include: 

1. HP D530 PC workstation with Windows XP Professional, Service Pack 1. 

2. Compaq Evo n610c laptop computer with Windows XP Professional, Service Pack 1. 

3. HP Omnibook 4100 laptop computer with Windows 2000 Professional, Service Pack 3. 

4. HP PC System Management Station (SMS) server, with Windows 2000 Server, Service 
Pack 4. 

5. HP ML350 server with Windows 2003 Server. 

The Software Stack 

The software configuration required for nPartition management varies depending on the 
operating system on which the software is executed. 

The first version of the par commands was delivered on HP-UX Hi version 1. The 
commands made configuration queries and changes through a proprietary system firmware 
interface specific to PA-RISC. HP-UX Hi version 1 commands do not support remote 
management. 

The second version of the nPartition commands was delivered first on HP-UX 1 li version 2, 
and subsequently on selected versions of Microsoft Windows. These commands support 
remote management in two ways. First, they use the WBEM protocol (WMI on Windows 
operating system versions), which permits a client-server access model. The command acts as 
a WBEM or WMI client, which makes requests of a provider. That provider may be accessed 
on a remote system through secure HTTP, or accessed on a local system through system calls. 
Because the commands and provider for nPartition configuration were first developed on HP- 
UX, they use the Open Group's open-source WBEM client interfaces and server software, 
Pegasus. Pegasus uses an XML-based communication protocol and data formats over secure 
HTTP, which is different than that used by Microsoft's WMI implementation. 
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NPartition Command 
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r HTTPS or local call 


WMI Mapper + WMI 
(Microsoft Windows) 


Pegasus CIM server 
(HP-UX) 



nPartition Provider 



IPMI 
MP 



Therefore, on Microsoft Windows there must be a software layer to translate between the 
Pegasus protocol and data format and the WMI protocol and format. The WMI Mapper 
component provides this translation, allowing client applications and providers developed for 
Pegasus to be easily ported to Microsoft Windows. The figure above shows a typical data 
path. A Pegasus client, such as the parstatus command, sends a Pegasus-formatted request to 
the WBEM server on a known network port. That request is translated to WMI format by the 
WMI Mapper, is forwarded to the WMI server, which in turn sends it to the appropriate 
provider, in this case the nPartition provider. The provider uses API services provided by the 
WMI Mapper to translate the request back to Pegasus format, queries the management 
processor for necessary information, and sends a response back to the client application 
through the server. 

Communication between the par command and the WMI Mapper is through a local system 
call or, when the provider is located on a remote system, by secure HTTP. The provider 
communicates with the partitionable complex Management Processor (MP) through the IPMI 
protocol. When sent over the LAN, the IPMI messages are encrypted. 

This strategy permits a number of methods to configure a partitionable complex, depending 
on where the client command and the nPartition provider execute. 
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Configure the local complex from a nPartition on the complex 




The simplest nPartition management configuration is when all software components run on 
an nPartition in the complex. The commands require no command line arguments giving the 
target of the operation, as the default is the complex where the local operating system is 
running. The par commands communicate with the provider by a local WBEM or WMI 
connection, which in turn connects to the complex MP through the IPMI block transfer (BT) 
protocol, via a dedicated controller in the MP. 

Currently, this configuration is supported only for HP-UX. The par commands and provider 
have not yet been ported to Windows 2003 Server for Itanium® 2. If a command is installed 
and run on a non-partitionable system, without options that specify a remote complex or 
nPartition as the target of the command, it will return an error message indicating that the 
platform is unsupported or not partitionable. 

Note that on older partitionable systems, such as the SD-32000 or rp8400, where HP-UX 1 li 
version 2 is not supported, this is the only method of configuring the complex using the 
nPartition commands. In that case, as mentioned above, there is no provider component. The 
commands communicate directly with the MP through a proprietary system firmware 
interface rather than IPMI/BT. 



8 



Configure a remote complex through a nPartition on that complex via 
WBEM/WMI 




A partitionable complex can also be configured remotely. The Microsoft Windows and HP- 
UX 1 li version 2 par commands can use the WBEM protocol to communicate with a 
provider on a remote nPartition, and so can be run on any platform where the commands are 
supported. 

The command sends a WBEM request to the provider by secure HTTP. The provider on the 
target nPartition communicates with the MP as in the previous scenario. 

While the command may be run anywhere that it is supported, the remote nPartition must be 
running HP-UX 1 li version 2 or later, as the provider has not yet been ported to Windows 
2003 Server for Itanium® 2. The PC must also have SSL certificates properly configured to 
permit the secure HTTP communication to take place. The procedure to configure SSL 
certificates is described in Appendix A. 



9 



Configure a remote complex through its MP via IPMI over LAN 




The nPartition commands and provider can also both execute on the remote management 
station, which may be either an IA-32 PC running a supported Microsoft Windows OS as 
described in the previous section, or a system running HP-UX 1 li version 2. 

The command communicates with the local provider using a local WBEM connection. The 
provider then communicates with the MP on the remote complex using the IPMI protocol 
over a LAN connection. 

This is the primary mode in which commands run on a supported Windows PC would be 
used to configure a remote complex, and the only mode in which commands run on a 
supported Windows PC can configure a remote complex where all nPartitions are not booted, 
are running Windows 2003 for Itanium® 2, or some combination of the two. 
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Installation and Troubleshooting Installation Problems 



Installation Process for the Windows Par CLI components 

1. Prepare the target complex for remote partition management, if not already done. On the 
target complex MP, enable IPMI LAN access with the SA command, and set an IPMI 
password with the SO command. See the HP System Partitions Guide (Reference 1) for 
more information. 

2. Install necessary patches, if not already done. Note that all required patches are pre- 
installed on a management console PC system, but must be manually installed on other 
PCs that might be used as a remote management station. See Appendix A for details. 

3. Install the WMI Mapper component. Double-click or select Install from the context 
menu for file WMIMapper.msi. Follow the installation wizard instructions. 

4. Install the nPartition commands component. Double-click or select Install from the 
context menu for file nParCommands.msi. Follow the installation wizard instructions. 

5. Install the nPartition provider component. Double-click or select Install from the context 
menu for file WMInParProvider.msi. Follow the installation wizard. Reboot the system 
if requested. 

6. If management of a remote nPartition via WBEM will be needed, configure the SSL 
Trusted Certificate Store on the PC. Instructions for this are in Appendix A of this 
document and in the on-line README file. 

Notes: 

1. Steps 4 and 5 above can be performed in any order. The order above places the reboot at 
the end of the installation procedure. If the nPartition provider is installed before the 
commands, the reboot, if requested, can be deferred until after the commands are 
installed. 

2. If only remote management via WBEM will be used from the PC, the provider 
component is not required. Install only the WMI Mapper and commands components, 
and configure the SSL Trusted Certificate Store. Skip step 5, but perform step 6 in this 
case. 

3. If only remote management via IPMI over LAN will be used from the PC, the SSL 
Trusted Certificate store need not be configured. Skip step 6 in this case. 

The installation packages will check that the proper versions of other components and all 
required patches are installed before proceeding. 
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Operation and Troubleshooting Operational Problems 



The par commands can be run from any command prompt after the PC is rebooted following 
the installation, as the directory containing the commands will be in the command PATH. 
When using remote configuration via WBEM, the -u and -h options must be used on the 
command line. When using remote configuration via IPMI, the -g and -h options must be 
used on the command line. At the current time, one of these two methods must be used when 
running the par commands from a Windows PC. 

See the HP System Partitions Guide (Reference 1), the commands on-line manual available 
from the Start menu (Programs\Hewlett-Packard\nPar Management\nPar Commands 
Manual), and the on-line README file also available from the Start menu 
(Programs\Hewlett-Packard\nPar ManagementVREADME) for more information on 
command options and operation, and applicable release notes. 

Environment variables 

The commands and provider require that the %PEGASUS_HOME% environment variable be 
set. In addition, the %PATH% environment variable must contain the directory in which the 
par commands are installed, or the command must be run with its full directory path listed, 
e-g- 

"c:\Program Files\Hewlett-Packard\nPar Management\parstatus.exe". 

Error messages 

See Appendix B for a list of error messages that can occur during operation of the commands. 
Note that due to limitations in the Microsoft WMI implementation, some of the error message 
data returned by the nPartition provider is not transmitted through the WMI server to the 
client command when an error occurs. However, under Windows, the provider logs the error 
data in the Application Event Log (AEL). Additional information about an error can be 
obtained by examining the most recent entries logged by the nPartition provider in the AEL. 
The AEL can be accessed from the context menu on the "My Computer" desktop object. 
Select My ComputerMVlanage, then when the application opens, select System Tools\Event 
Viewer\Application in the left hand pane. Select an entry in the right hand pane and then 
choose the Properties action from the context menu to see the message itself. 

Testing the nPar Commands 

To verify the correct operation of the complete software stack, one can perform the following 
simple tests. 

1. Open a command prompt window, for example by selecting Start • Programs • 
Accessories • Command Prompt. Then type the command 

C:\Windows> parstatus -X 
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• This command will attempt to display complex-wide attributes for the management PC 
itself, which is not a partitionable system. The command should be found in the PATH, 
but result in the following message. 

Error: unsupported platform 

• Since the management PC is not a partitionable platform, the command will fail as above, 
but to do so the command must have successfully contacted the provider through the 
WMI Mapper. 

2. If access to an partitionable complex that supports remote management is available, e.g. 
HP Integrity Superdome, HP Integrity rx8620, or HP Integrity rx7620, type the following 
command: 

C:\Windows> parstatus -X -h <mp> -g <password> 

Where <mp> is either the IP address or the hostname of the MP of the partitionable system, 
and <password> is the MP IPMI password. This command should result in the display of 
approximately 10 partitionable complex attributes, including the complex name, model 
number, and so on. There may be a delay of a few seconds up to a minute or more, depending 
on network distance from the management PC to the partitionable system. 

Locating the source of a problem 

With a set of 3 software components, locating the source of a problem can sometimes be 
difficult. In cases where the error message does not describe the source of the problem, or 
when the error can result from multiple causes, the "wmiop.exe" utility included with the 
WMI Mapper component can be used to assist in this process. Use of this utility to locate 
problems is described in Appendix C. 

Some issues with IPMI over LAN operation 

The IPMI specification requires that LAN traffic be sent as datagrams with the UDP protocol, 
which does not guarantee delivery of a datagram. In addition, a large data structure 
containing static configuration information about the target complex must be downloaded 
from the complex MP by the nPartition provider. This data gives the provider the necessary 
information to request dynamic information about the complex. This can cause the following 
issues: 

1. The first time that a particular remote complex is accessed by a par command, using 
IPMI over LAN, the command can take significantly longer to complete, as much as 2 
minutes or more, depending on the speed of network communication between the remote 
management PC and the complex MP. The provider caches the static data and reuses it 
for subsequent requests, so future invocations of any par commands will not incur this 
initial overhead. However, if the nPartition provider is restarted for any reason, this 
cached data is lost. The first data request to the MP after the restart will incur the same 
startup overhead. 
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The speed and reliability of network communication between the remote management PC 
and the complex MP has a large effect on the reliability of command execution. Since the 
UDP protocol does not guarantee datagram delivery, the provider will retry a number of 
times when packets fail to arrive in a reasonable time, but if the network connection 
between the PC and MP is too unreliable or slow, the provider will eventually time out 
and return an error to the par command. This is often seen as a display of the message 
"[X] data is not available", where [X] might be cell, I/O chassis, cabinet, or other data 
about the complex. Best performance and reliability is obtained when the PC and MP are 
on the same subnet, in close network proximity. Long distance network access is 
possible, but may be unreliable or slow. The longer the distance, and the slower or more 
unreliable the connection, the worse this effect will be. In the worst case, it can cause the 
commands to be effectively unusable. This effect is noticed most often when using the 
parstatus command, which has the highest required data volume. Other commands tend to 
require less data, and so may be more reliable in situations where parstatus is 
problematic. However, since parstatus displays the current complex configuration, its use 
is normally critical to getting the correct configuration settings. When this occurs, but 
remote management is required, it is better to remotely access a PC on the same subnet as 
the complex MP using Remote Desktop Services, or other methods as described later, 
and configure the complex from that "closer" PC. 



Remote Management Network Options and Issues 



The network configuration of the partitionable complex with respect to the PC where the 
partition commands will be executed will affect the methods by which the commands can be 
executed. Generally, there are three options. Selection of a method will depend on the 
hardware available and security concerns for the particular installation. 



Management station PC on general use LAN 

PC 




Partitionable 
System 



The simplest option is to connect the remote management PC, the nPartition and the MP to a 
general puipose LAN. In this configuration, the PC used for remote management can access 
both the nPartition (if running HP-UX 1 li version 2 or later) using the -u and -h options and 
the MP using the -g and -h options. The PC need not be dedicated to nPartition management 
and can be used for other work. However, this is the least secure method. It depends on the 
encryption used in the secure HTTP connection to the nPartition or that used in the IPMI 
LAN session to prevent passwords and other data from being extracted, and makes the MP 
widely accessible. 
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Management station PC on dedicated management LAN 

Intranet 




Partitionable 
System 



Management 
LA 

N 



A more secure method is to place the remote management PC and the MP on a dedicated 
management LAN, physically separate from the general use LAN. This is more secure, but 
also less flexible, as the PC used for partitionable complex management must be dedicated 
for that purpose. 



Management station PC on both dedicated management LAN and intranet LAN 





Intranet 



Partitionable 
System 







MP 



Management 
LA 

N 



A third option is to have physically separate LANs and connect the PC used for remote 
management to both of them. This requires that the PC contain two network interface cards. 
With supported Windows operating systems, no special configuration of the commands is 
required, as long as the network interfaces themselves are configured to access the correct set 
of network addresses. Windows will route network traffic appropriately. The general purpose 
LAN would be used for remote WBEM connectivity to an HP-UX 1 li version 2 nPartition ( - 
u and -h options), and the management LAN would be used for IPMI over LAN connectivity 
to the MP (-g and -h options). This method is more complex, but keeps partition 
configuration network traffic off the general use LAN when the -g option is used, while still 
permitting the remote management PC to be used for other purposes. 
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A similar option is to connect the two LANs with an intelligent router or access server that 
can restrict access to the management LAN to a particular set of PC systems or users 
authorized to connect to it. This method restricts the network visibility of the MP to specific 
systems or users, and allows the remote management PC to be used for other purposes as 
well, but does put the encrypted passwords and other data on the general use LAN. 




Intelligent 
router or 
access server 



~1 



nPar 



MP | 



Intranet 



Partitionable 
System 



Management 
LA 
N 



Accessing the management station PC remotely 

As previously noted, it is desirable to have the client that is running the par commands near 
the complex it is managing, to minimize the probability of UDP datagrams being lost in the 
WAN environment. 

Given that a company's main support center may be geographically dispersed from its 
datacenter, this would mean the par commands should be deployed near the datacenter where 
network latency is minimal and network reliability is best. The Administrator could then use 
a desktop remote control package, which will incorporate an underlying network protocol 
more suitable for dispersed WAN links, to access the management station PC. 

The options available are based on the Windows Operating System where the par commands 
are installed. The next few paragraphs describe the available options. 

Third Party Remote Control Software (Suitable for Windows 2000 
Professional) 

Windows 2000 Professional did not ship with a method for remote control of the desktop. 
The only option is to add another vendor's remote control software such as Symantec's 
PC Any where® or an Open Source product such as Win VNC (from www.realvnc.com ). 
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The implementation details of Third Party products are beyond the scope of this document, 
but each one has supporting documentation on how to make the client running the par 
commands available for remote desktop control. 

Terminal Services (Suitable for Windows 2000 Server and Windows 2003 
Server) 

The server editions of Windows 2000 and Windows 2003 come with a service known as 
Terminal Services. Terminal Services has the ability to create another log on session that is 
different to the console, and leaves the console still available for other administration work. 

Terminal Services is configurable in two modes - "Application mode" and "Administration 
Mode" which have major differences in licensing terms, and predominantly subtle differences 
in Application Compatibility. The ParCLI application is supported on Terminal Services in 
both "Application mode" and "Administration mode". 

For normal use, an administrator will only enable Terminal Services for "Administration 
mode". This particular mode does not require any further licensing, and does not need 
License Activation, but due to this has two major restrictions. Firstly only two connections 
can be made concurrently in "Administration Mode", and the users logging in must be 
members of the Administrator's group. When installing Terminal Services, this is the default 
mode that is configured unless otherwise specified. 

There is a slight difference in installing Terminal Services between Windows 2000 and 
Windows 2003. In Windows 2000 Server, Terminal Services must be installed by clicking its 
checkbox in Add Windows Components. In Windows 2003 it is installed by default, although 
the "Terminal Services" checkbox is not clicked. The checkbox in Windows 2003 is purely 
reserved to install Terminal Services in "Application Mode". Lastly, with Windows 2003 to 
enable connection to the Terminal Service you must enable remote connection via the System 
Properties "Remote" tab for the computer. This will allow you to connect. 

Once installed, a client access portion of Terminal Services is required for the PC (or PC's) 
that will connect to the client running ParCLI. This is generally called "Remote Desktop 
Connection" and is available as installable image that is included with the Operating Systems, 
or is downloadable separately on the Microsoft website. Windows XP already has the Remote 
Desktop Client installed by default. It is available at Start > All Programs > Accessories > 
Communications > Remote Desktop Connection. 

More information on Terminal Services can be found at the Microsoft Windows 2003 
Technology Center located at 

http://www.rnicrosoft.corn/windowsserver2003/technologies/terminalservices/default.mspx 
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Remote Desktop Services (Suitable for Windows 2003 Server and Windows 
XP) 



Windows Server 2003 and Windows XP also have the ability to remote the desktop similar to 
Third Party applications such as PC Anywhere. 

By default neither Operating System allows this to occur. You must enable it by the System 
Properties "Remote" tab for the computer. This will allow the Remote Desktop Connection 
program to connect directly to the client's console. Please note an additional step is required 
to connect to a Windows 2003 console, whereby the /console switch must be used with the 
Remote Desktop Connection application. This is only present on the newest application 
downloadable from Microsoft and also available as an install image with Windows 2003 (it is 
a 32 bit program that is available on both the 32bit and 64 bit Windows 2003 server operating 
systems). 

Telnet 

Since the par commands are executed from a command prompt, it is also possible to use a 
telnet application (either the telnet command delivered with Microsoft Windows, or a third 
party application such as Reflection® 1) to open a command prompt on the remote 
management PC. The remote management PC must have the Telnet service installed and 
started. There may be limitations on the number of telnet connections permitted into the 
remote management PC by the host operating system. Simply invoke the telnet application on 
the PC, giving it the hostname or IP address of the remote management PC as the target. Log 
in to the telnet server with a valid username and password. From there, execute par 
commands as if running in a command prompt on the remote management PC. However, 
only commands may be used in this mode. No GUI application may be run. 

OS Service Pack Upgrade Issues 

Until the required patches and hotfixes are incorporated into Windows service packs, it is 
possible that upgrading the service pack level of the OS after installing nPartition components 
could affect operation. 

1. Windows 2000 Professional or Server. Upgrading from Service Pack 3 to Service Pack 4 
after installing the nPartition components causes no issues. 

2. Windows XP Professional. Upgrading from Windows XP to Windows XP Service Pack 1 
can overwrite a file replaced by the Q332207 hotfix with an older version. Reinstalling 
the hotfix will correct the problem. 
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Appendix A: Installation and Configuration Details 

Configuring the SSL Trusted Certificate Store on Windows. 

1. Locate the SSL Trusted Certificate Store on the target nPartition. 

a. Locate the configuration file for the HP-UX CIM server on the remote HP-UX 1 li 
version 2 nPartition through which the complex will be managed. This is normally in 
file $PEGASUS_HOME/cimserver_current.conf. 

b. Open the configuration file. Search for the entry: 
sslCertificateFilePath=<path/filename>. If there is no sslCertificateFilePath entry in 
the file, the default value is $PEGASUS_HOME\server.pem 

c. The file named in the entry is the SSL Trusted Certificate Store file, by default 
$PEGASUS_HOME\server.pem. 

2. Open the certificate file, and copy everything from the text " BEGIN CERTIFICATE- 

to " END CERTIFICATE ", inclusive, into a separate file. 

3. Locate the SSL Trusted Certificate Store on the PC where the commands will be run. If 
the PC has been configured with the HP Shared Certificate Store, the file will be located 
at %HP_SSL_SHARE%\client.pem. Otherwise, the default location is 
%PEGASUS_HOME%\client.pem. 

4. Append the certificate data copied in step 2 above to the end of the client.pem file 
identified in step 3. 

Required Patches 

The required patches are available on the Smart Setup media on which the commands 
themselves are delivered. Note that patches need only be installed once. When reinstalling or 
upgrading the other components of the nPartition management software stack, the patches 
need not be reinstalled. 

1. On Windows 2000 Server or Professional with Service Pack 3 or later, install the WMI 
extension in file "wmirdist.msi". Then install hotfix Q332207 for Windows 2000. 

2. On Windows XP with Service Pack 1 or later, install only hotfix Q332207 for Windows 
XP. 

3. On Windows 2003, no patches or hotfixes are required. 
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Appendix B: Error messages 



Par commands messages 

The following messages are written to standard output by the commands. Note that this list 
does not include messages concerning syntax errors or errors caused by attempting a 
configuration change that is not valid for the current configuration, e.g. removing a cell from 
a partition that is not assigned to that partition. Those messages are generally self- 
explanatory, but additional information about the operation of the commands can be obtained 
from the HP System Partitions Guide (Reference 1). 



Message 


Cause 


Action 


Unsupported Platform 


a. Command was run on the local 
system, which is not a 
partitionable server. 

b. With -u and -h options, target 
host is not a partitionable server. 


A. Use the -g and -h options or 
the -u and -h options to specify a 
partitionable complex as the 
target of the operation. 

b. Specify the hostname or IP 
address of an nPartition. 


The nPartition Configuration 
Privilege of the target complex is 
restricted. 


The MP is set to disallow changes 
to the configuration of any 
nPartition except the one from 
which the request is made. 


This can only occur when using 
the -u option. In that case, specify 
the nPartition that will be altered 
as the target in the -h option. See 
the HP System Partitions Guide 
for more information. 


Cannot determine the state of the 
nPartition Configuration Privilege. 


The command cannot retrieve this 
data from the provider. In most 
cases, this is caused by 
excessive lost packets during 
data retrieval. 


Retry the command, or use a 
management PC with more 
reliable network communications 
to the MP. 


Cannot determine if the platform 
is partitionable. 


a. See "Error: unsupported 
Platform" above. 

b. The command cannot retrieve 
this data from the provider. In 
most cases, this is caused by 
excessive lost packets during 
data retrieval 


b. Retry the command, or use a 
management PC with more 
reliable network communications 
to the MP 


Cannot write the Stable Complex 
Configuration Data. 

Cannot write the Partition 
Configuration Data 

Unable to update the Stable 
Complex Configuration Data. 


The referenced data is 
inaccessible or was left in a 
locked state. See the AEL entry 
for more information. 


If the data was left locked, use the 
command "parunlock" to unlock it. 
See the on-line help for the 
parunlock command, and the HP 
System Partitions Guide for more 
information. 



continued 
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Par commands messages continued 



Message 


Cause 


Action 


Cannot lock Stable Complex 
Configuration Data. 

Cannot lock Partition 
Configuration Data. 

Cannot lock cell data for cell <n> 


The referenced data was locked 
when the command attempted to 
access it. 


First retry the command. The data 
is normally locked only for short 
periods. If the data remains 
locked, use the command 
"parunlock" to unlock it. See the 
on-line help for the "parunlock" 
command and the System 
Partitions Guide for more 
information. 


Cannot read <info> 
Unable to read <info> 


In most cases, these messages 
are caused by lost datagrams 
over an unreliable network 
connection. See the AEL entry for 
more information. 


Retry the command, or use a 
management PC with a more 
reliable network connection to the 
target MP or nPartition. 


Unable to get <info> 

No information available for 
<component> 

<Component> information 
unavailable. 


<info> will be a identification of 
the specific data not available. 

<component> will be an 
identification of the specific 
component for which data was 
unavailable. 




LED operation on <component> 
failed. 


Attempted to turn on or off an 
LED that does not exist on the 
target complex. Only Superdome 
servers support all LEDs. 
Midrange partitionable servers, 
e.g. rx8620, do not have cabinet 
or I/O chassis LEDs. See the AEL 
entry to confirm this was the case. 


Do not specify a non-existent 
LED. 
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Provider messages 



The following messages will be found in Application Event Log entries. In most cases, 
additional amplifying information will follow the general message. 



Message 


Cause 


Action 


Operation failed. 


Request could not be completed. 


See additional information in AEL. 


Firmware error. 


System firmware failed to perform 
the requested operation. 




Service processor error. 


MP firmware failed to perform 
requested operation. 




The power-on request could not 
be satisfied because an N- power 
condition would result. 


There is insufficient system power 
to service a cell that was specified 
to be powered on. 


Add additional power supplies or 
replace a defective power supply. 


The power-on request could not 
be satisfied because an 
insufficient cooling condition 
would result. 


There is insufficient system 
cooling to service a cell that was 
specified to be powered on 


Add additional fan or blower units 
or replace a defective fan or 
blower. 


Timed out waiting for a response. 


Datagram was lost. 


Retry command or use a 
management PC with a more 
reliable connection to the target 
MP or nPartition. 


Insufficient privilege to perform 
the operation. 


Requesting user does not have 
permission to perform the 
requested operation 


Run the command as 
Administrator or "root". 


Invalid user name 


Username specified in the request 
was not valid on the target 
nPartition. 


Use a valid username. 


Operation is only supported by 
the local operating system. 


The requested operation can only 
be performed by a provider 
running on the nPartition. It 
cannot be performed through the 
MP. 


Use the -u option with the 
command. 


Operation is not supported by the 
firmware. 


The system firmware does not 
support the requested operation. 


Cannot perform the request on 
this target system. May require 
updating the system firmware on 
the target system. 


Operation is not supported by 
either operating system or 
firmware. 


Neither the local OS nor system 
firmware supports the requested 
operation. 


Cannot perform the request on 
this target system. May require 
updating the OS or system 
firmware on the target system. 


Operation is not supported by the 
provider. 


The provider does not support the 
requested operation. 


Update the provider to the most 
current revision. 


Invalid parameter 


Invalid data passed with the 
request, for example, an invalid 
cell id. 





continued 
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Provider messages continued 



Message 


Cause 


Action 


The specified item does not exist. 


The specified component does 
not exist, e.g. a cell that is not 
installed in the complex. 




The system interface version 
does not match that expected by 
the provider. 


The version of IPMI on the target 
MP is unexpected. This is 
normally caused when the target 
platform has an MP that supports 
IPMI, but is not partitionable. 


Specify a partitionable complex 
MP as the target of the operation. 


The service processor does not 
support I/O expansion cabinets. 


A request for data about an I/O 
expansion cabinet was requested 
on a platform that does not 
support them, e.q. rx7620. 


Cannot perform the requested 
operation on this platform. 


Operation is not supported by the 
platform. 


A request was made that is 
supported by the platform. 
Generally, this would be caused 
by running a command intended 
for a later model of a system on 
an earlier model that does not 
support the feature. 


Cannot perform the requested 
operation. 


Locking or unlocking the target 
failed. 


The target of the lock was already 
locked, or the lock was held by a 
different process. 


Retry the command. If necessary, 
use the parunlock command to 
unlock the data. 


Command processing resources 
are temporarily unavailable. 


The MP is busy with another 
request. 


Retry the command. 


IPMI session error 


Error in the IPMI communication 
between the provider and the MP. 


Retry the command 


No changes can be made 
because the profile is already in 
the process of being changed. 


Another user has initiated a 
complex reconfiguration. Until the 
MP has completed, this 
configuration, no other can be 
performed. 


Retry the command at a later 
time. 


LOCKing or uniocKing ine largei 
failed because the MP has target 
locked. 


i ne ivir nas locKeo ine requesieu 
data for internal use. 


neiry ine cornrTiana ai a later 
time. 


The platform is not supported. 


The target is not a partitionable 
complex. 




The system is not using a 
compatible version of IPMI. 


The target of the operation is not 
a partitionable complex. 
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Appendix C: Use of wmiop to locate problems 

Wmiop.exe is installed in the %PEGASUS_HOME%\bin directory. Since this directory is 
added to the PATH during installation, wmiop can be executed from any directory. If not, 
that is the first indication that something is wrong, most likely that the PATH environment 
variable has not been correctly modified. 

The syntax of the wmiop utility is as follows (an abbreviated usage message can be viewed 
from the command line by running "wmiop" with no options): 

Usage : 

wmiop <cimoperation> [arg, . . .] 

Implemented operations (not case sensitive) are: 
getClass[gc <class> 

enumerateClassNames | ecn [ <class> ] 
getlnstance | gi <class> [ list ] 
enumeratelnstances [ ei <class> 
enumeratelnstanceNames | ein <class> 

getProperty | gp <class> { ask | list } [ <propnam> ] 

setProperty | sp <class> { ask | list } [ <propnam> [ <value> ] ] 

deleteClass | dc <class> 

createlnstance | ci <class> 

modif ylnstance | mi <class> [ list ] 

deletelnstance | di <class> [ list ] 

Examples : 
wmiop ecn 

wmiop enumerateinstancenames Win32_OperatingSystem 
wmiop gi Win32_Process list 
wmiop ei Win3 2_ComputerSystem 

Environment variables : 
CIM_NAMESPACE -- if not defined use root/cimv2 
CIM_HOST -- local connect if not defined 

CIM_PORT -- port number (default determined by CIM_NOSSL) 
CIM_NOSSL -- if defined, connect unencrypted to 5988, else 5989 
CIM_USER -- user 
CIM_PASSWORD - password 

Notes : 
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- by setting CIM_NAMESPACE appropriately, instances of Namespace 

can 

be enumerated, created, and deleted. 

- The C I M_NAME S PACE variable must be set to the correct and 
desired 

namespace before running the WMIOP application. 

- When an invalid classname is provided, the application will 
abort its 

operation . 

- It is not recommended redirect the WMIOP output to a file. Some 

operations require user input after the command line call and 
these 

inputs may be omitted. 

Test the WMI Mapper Installation 

The following tests that the WMI Mapper files are installed correctly, and are accessible via 
the current system PATH. 

Open a Command Prompt window and run the following command: 
wmiop ei Win3 2_ComputerSystem 

This command requests that WMI enumerate the instances of all known objects of type 
Win32_ComputerSystem. If the WMI Mapper is installed and operating correctly, then 
output similar to the following should result. The specific values will be different for each 
machine. If an error occurs, uninstall, then reinstall the WMI Mapper. 

Instances of [Win3 2_ComputerSystem] (1 instances) : 

Instance of Win3 2_ComputerSystem: 
{ 

AdminPasswordStatus = 3 
AutomaticResetBootOption = TRUE 
AutomaticResetCapability = TRUE 
BootROMSupported = TRUE 
BootupState = "Normal" 
Caption = " FCTMARTIN" 
ChassisBootupState = 3 

CreationClassName = "Win32_ComputerSystem" 
CurrentTimeZone = -420 
DaylightlnEf feet = FALSE 
Description = "AT/AT COMPATIBLE" 
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Domain = "DOMAIN-NAME" 
DomainRole = 3 
FrontPanelResetStatus = 3 
Inf raredSupported = FALSE 
KeyboardPasswordStatus = 3 
Manufacturer = "Hewlett-Packard" 
Model = "HP Kayak PC" 
Name = "HOSTNAME" 
NetworkServerModeEnabled = TRUE 
NumberOf Processors = 1 

OEMStringArray [•] = "SMBIOS 2.3 BIOS with HP DMI extensions " 

PauseAf terReset = -1 

PowerOnPasswordStatus = 3 

PowerState = 0 

PowerSupplyState = 3 

PrimaryOwnerName = "Joe Owner" 

ResetCapability = 1 

ResetCount = -1 

ResetLimit = -1 

Roles [•] = "LM_Workstation LM_Server NT Server_NT Backup_Browser 

ti 

Status = "OK" 
SystemStartupDelay = 3 0 

SystemStartupOptions [•] = ""Microsoft Windows 2000 Server" 
/fastdetect " 

SystemStartupSetting = 0 

SystemType = "X86 -based PC" 

ThermalState = 3 

TotalPhysicalMemory = 1341636608 
UserName = "DOMAIN-NAME\j owner " 
WakeUpType = 6 

} 

Test the WMI Mapper Service with HTTP Connections 

The following will test that the WMI Mapper service is running and properly responding to 
client requests. Note that running the nPar commands with the -g option (to connect remotely 
to the Management Processor on the partitionable system) does not go through the WMI 
Mapper service, so this test does not apply for those cases. 
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The following test uses a basic HTTP connection to the service, which eliminates any 
possible SSL/certificate problems. By default, the WMI Mapper service is configured for 
HTTPS/SSL connections ONLY, therefore this test will not work without first reconfiguring 
the service for HTTP connections. See the installed file 

%PEGASUS_HOME%\ConfigREADME.txt for instructions on how to configure the service. 
To test the default configuration (HTTPS connections), skip to the next test, below. 

Open a Command Prompt window and run the following commands: 
set CIM_HOST=localhost 
set CIM_USER=<domain\username> 
set CIM_PASSWORD=<password for user, above> 
set CIM_NOSSL=l 
wmiop ei Win3 2_ComputerSystem 

The output should be the same as the previous test. If an error occurs, ensure that the WMI 
Mapper service is started. If not start it and repeat the test. If it is running, uninstall, then 
reinstall the WMI Mapper. 

If you see the following error: 

Cannot connect to localhost:5988. Connection failed 

The most likely cause is that the server is not configured for HTTP connections. As noted 
above, the default configuration is for HTTPS connections only. To configure the service for 
HTTP connections, open the %PEGASUS_HOME%\cimserver_planned.conf file and 
add/edit the following entry: 

enableHttpConnection=true 

Then Restart (or Stop then Start) the Pegasus WMI Mapper service from the Services control 
panel for the change to take effect. 



Test the WMI Mapper Service with HTTPS Connections 

The following will test that the WMI Mapper service is running and properly responding to 
client requests by secure HTTP. Note that running the nPar commands with the -g option (to 
connect remotely to the Management Processor on the partitionable system) does NOT go 
through the WMI Mapper service, so this test is N/A for those cases. 

The following test uses HTTPS/SSL connections to the service, which assumes the default 
WMI Mapper configuration for HTTPS/SSL connections (see the installed file 
%PEGASUS_HOME%\ConfigREADME.txt for instructions on how to configure the 
service). 

Open a Command Prompt window and run the following commands: 

set CIM_HOST=localhost 

set CIM_USER=<domain\username> 

set CIM_PASSWORD=<password for user, above> 
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The current directory must be where the client.pem file resides (either the PEGASUS_HOME 
or the HP_SSL_SHARE directories): 

cd %PEGASUS_HOME% 

Finally, run the wmiop command: 

wmiop ei Win3 2_ComputerSystem 

The output should be the same as the previous test. If an error occurs, uninstall, then reinstall 
the WMI Mapper. If an SSL certificate problem is suspected, try deleting the entire 
%PEGASUS_HOME% and %HP_SSL_SHARE% directories after un-installing and before 
reinstalling. This will delete all installed certificates, causing the certificates to be re- 
generated during installation. Then follow the instructions for configuring SSL Shared 
Certificates from Appendix A. 

Test Registration of the WMI nPar Provider 

The following test ensures that the nPar Provider has been properly registered in WMI: 

Open a Command Prompt window and run the following commands: 

set CIM_NAMESPACE=root/cimv2/npar 
wmiop ecn 

The output should be as follows, indicating the nPar Provider is properly registered in WMI: 

Classes in namespace [root/cimv2/npar] : 

SystemClass 

NAMESPACE 

Provider 

Win32 Provider 

HP_DecoupledProvider 

ProviderRegistration 

Obj ectProviderRegistration 

InstanceProviderRegistration 

Class ProviderRegistration 

Proper tyProviderRegi st rat ion 

MethodProviderRegistration 

Event ProviderRegistration 

Event Consumer ProviderRegi st rat ion 

_CIMOMIdentif ication 

IndicationRelated 

Event 

ExtrinsicEvent 

SystemEvent 
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EventDroppedEvent 

EventQueueOverf lowEvent 

ConsumerFailureEvent 

NamespaceOperationEvent 

NamespaceCreationEvent 

NamespaceDeletionEvent 

Name spaceModi f i cat ionEvent 

ClassOperat ionEvent 

ClassCreat ionEvent 

ClassDe let ionEvent 

ClassModifi cat ionEvent 

Ins tanceOperat ionEvent 

Ins tanceCreat ionEvent 

Ins tanceDe let ionEvent 

Ins tanceModi f i cat ionEvent 

TimerEvent 

AggregateEvent 

Event Consumer 

Event Filter 

FilterToConsumerBinding 

EventGenerator 

Timer Inst ruction 

Absolut eTimer Inst ruction 

IntervalTimer Inst ruction 

T ime rNext F i r ing 

Notif yStatus 

ExtendedStatus 

SecurityRelatedClass 

NTLMUser9X 

PARAMETERS 

SystemSecurity 

C I M_ManagedE 1 ement 
CIM_ManagedSystemElement 
CIM_LogicalElement 
HP_NParSlot 
HP_NParCellSlot 
HP_NParIOChassisSlot 
HP_NParCabinet 
HP_NParPowerCoolingDomain 
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HP_NParPotentialErrorObject 
HP_NParComponent 
HP_NParCell 
HP_NParIOChassis 
HP_NParProf ile 
HP_NParComplex 
HP_NParPartition 
HP_NParDynamicProf ile 
HP_NParCellConnectedToIOChassis 
HP_NParComponentInSlot 
HP_NParIOChassisInSlot 
HP_NParCellInSlot 
HP_NParSlotInCabinet 
HP_NParCellSlotInCabinet 
HP_NParIOChassisSlotInCabinet 
HP_NParCellSlotInPartition 
HP_NParDomainInCabinet 
HP_NParLocalPartition 
HP_NParRemoteComplex 

If an error occurs, or the output looks significantly different from the above, uninstall, then 
reinstall the nPar Provider, which will re -register the provider with WML 

Test Operation of the WMI nPar Provider 

This test ensures that the WMI nPar Provider is running and properly responding to client 
requests: 

Open a Command Prompt window and run the following commands: 

set CIM_NAMESPACE=root/cimv2/npar 
wmiop ci HP_NParRemoteComplex 

When prompted, enter the following information: 

[ key ] string Address? <Management Processor hostname or IP> 
string Password? <MP Admin password> 

If successful, you should see the following message: 

Instance [root / cimv2 /npar : HP_NParRemoteComplex .Address = " <mp 
address>"] successfully created! 

Otherwise, if you see the following error: 

Error: [6] CIM_ERR_NOT_FOTJND : The requested object could not be 
found 
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This indicates that the nPar Provider is either not running, or not handling requests 
appropriately. Verify that the WMI nPar Provider service is started. If not, start it from the 
Services control panel, or reboot and repeat the test. If the service is started, uninstall, then 
reinstall the provider. 
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